home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / Development / vbcc / doc / wosdb.doc < prev   
Encoding:
Text File  |  2002-10-27  |  2.9 KB  |  85 lines
  1. wosdb V0.4        VBCC ANSI C Compiler Reference Manual           wosdb V0.4
  2.  
  3.  
  4. NAME
  5.      wosdb - a simple WarpOS debugger
  6.  
  7.  
  8. SYNOPSIS
  9.      wosdb [file name] [arguments...]
  10.  
  11.  
  12. DESCRIPTION
  13.      wosdb is a low-level debugger, which supports basic debugger
  14.      functionalities like single-step trace mode, breakpoints, disas-
  15.      sembler, memory dump, etc.. It also takes advantage from symbol
  16.      hunks (HUNK_SYMBOL) in WarpOS programs.
  17.  
  18.      The debugger is not very useful, when the executable doesn't
  19.      provide any symbols, so you should make sure that your compiler
  20.      generates them.
  21.  
  22.      vbcc:
  23.           vlink must not strip any symbols from the final executable.
  24.           This can be achieved by omitting the options -s and -x. You
  25.           can make a new config file, e.g. "warpos_debug" for this
  26.           purpose.
  27.  
  28.      StormC:
  29.           Set the toggle for "Write Debugsymbols" in
  30.           Settings -> C/C++ Compiler -> Options.
  31.  
  32.      Note: egcs-WOS is not supported, because the generated code
  33.      doesn't conform to the PowerOpen-ABI, used under WarpOS.
  34.  
  35.      When arguments are specified behind the file name, they will
  36.      be passed via RunCommand() to the 68k launch code of the WarpOS
  37.      program.
  38.  
  39.  
  40. COMMANDS
  41.      +                  Skip to next instruction
  42.      -                  Skip to previous instruction
  43.      ?                  Show help
  44.      ? <exp>            Evaluate expression
  45.      @r<n> = <exp>      Set GP register
  46.      @f<n> = <flt exp>  Set FPU register
  47.      L "name" [args...] Load WOS program for debugging
  48.      U                  Unload current program
  49.      S                  Show all symbols
  50.      b                  Show all breakpoints
  51.      b <exp>            Set normal breakpoint (trap instruction)
  52.      bc <exp>           Clear breakpoint
  53.      bt <exp>           Set temporary breakpoint
  54.      d [<exp>]          Disassemble
  55.      fpr                Show FPU registers
  56.      g                  Run program
  57.      g <exp>            Run program until specified address reached
  58.      gpr                Show GP registers
  59.      m [<exp>]          Memory dump
  60.      n                  Break at next instruction (trace over calls)
  61.      r                  Show all CPU registers and current instruction
  62.      s                  Single step instruction
  63.      tb                 Show stack frame trace-back
  64.      x                  Exit debugger and unload debug task
  65.  
  66.  
  67. EXPRESSIONS
  68.      Expressions may consist of decimal, hexadecimal (0x...) or
  69.      octal (0...) constants, symbols (read from HUNK_SYMBOL) and
  70.      registers. The operations +, -, *, / and terms are allowed.
  71.      Registers can be referenced by using the '@' prefix, e.g. @r1
  72.      for contents of stack frame. Supported registers in expressions
  73.      are: @r<n>, @lr, @ctr, @pc
  74.  
  75.  
  76. LEGAL
  77.      wosdb is freeware.
  78.  
  79.  
  80. BUGS
  81.      I can't believe it... None? :)
  82.  
  83.  
  84. Frank Wille                  05-Mar-2000                frank@phoenix.owl.de
  85.